Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXConvertPrintRecordTo

QuickDraw GX sends the GXConvertPrintRecordTo message when an application that supports the Macintosh Printing Manager calls the GXConvertPrintRecordTo function, which converts a print record into a universal print structure format. You can override the GXConvertPrintRecordTo message if you have a printer driver written for the Macintosh Printing Manager whose print format you wish to continue to support. Your override of the GXConvertPrintRecordTo message must match the following formal declaration:

OSErr MyConvertPrintRecordTo (THPrint aTHPrint);

aTHPrint

A handle to the print record for this printing operation.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXConvertPrintRecordTo message does nothing.

SPECIAL CONSIDERATIONS

You never send the GXConvertPrintRecordTo message yourself.

You need to totally override the GXConvertPrintRecordTo message to support your Macintosh Printing Manager print-record format.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXConvertPrintRecordFrom function is described in Inside Macintosh: QuickDraw GX Printing.

The universal print structure is described on page 4-12.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help